docs: Document various entry ::activate signals

diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 4c41a3e34ef4f355dfe257abac9e30a5c5fb1101..3d058bad272ef246bfe5d5f9a916960be7e9ec01 100644 (file)
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -941,6 +941,14 @@ gtk_entry_class_init (GtkEntryClass *class)
   g_object_class_override_property (gobject_class, PROP_EDITING_CANCELED, "editing-canceled");
   gtk_editable_install_properties (gobject_class, PROP_EDITING_CANCELED + 1);
 
+  /**
+   * GtkEntry:activate:
+   * @self: The widget on which the signal is emitted
+   *
+   * The ::activate signal is forwarded from the
+   * #GtkText::activated signal, which is a keybinding
+   * signal for all forms of the Enter key.
+   */
   signals[ACTIVATE] =
     g_signal_new (I_("activate"),
                   G_OBJECT_CLASS_TYPE (gobject_class),

diff --git a/gtk/gtkpasswordentry.c b/gtk/gtkpasswordentry.c
index 216ae2d9156989aedf140f73624ce16a3ab45e80..ec8d08b1192d7567b50f816d2af30ef2bd587636 100644 (file)
--- a/gtk/gtkpasswordentry.c
+++ b/gtk/gtkpasswordentry.c
@@ -452,6 +452,14 @@ gtk_password_entry_class_init (GtkPasswordEntryClass *klass)
   g_object_class_install_properties (object_class, NUM_PROPERTIES, props);
   gtk_editable_install_properties (object_class, NUM_PROPERTIES);
 
+  /**
+   * GtkPasswordEntry:activate:
+   * @self: The widget on which the signal is emitted
+   *
+   * The ::activate signal is forwarded from the
+   * #GtkText::activated signal, which is a keybinding
+   * signal for all forms of the Enter key.
+   */
   signals[ACTIVATE] =
     g_signal_new (I_("activate"),
                   G_OBJECT_CLASS_TYPE (object_class),

diff --git a/gtk/gtksearchentry.c b/gtk/gtksearchentry.c
index 80304901b69a241642ebd866f734a9ef762ba4f1..4960c9894144dc5dd76eb59aa09e6ae896be185c 100644 (file)
--- a/gtk/gtksearchentry.c
+++ b/gtk/gtksearchentry.c
@@ -295,6 +295,14 @@ gtk_search_entry_class_init (GtkSearchEntryClass *klass)
   g_object_class_install_properties (object_class, NUM_PROPERTIES, props);
   gtk_editable_install_properties (object_class, NUM_PROPERTIES);
 
+  /**
+   * GtkSearchEntry:activate:
+   * @self: The widget on which the signal is emitted
+   *
+   * The ::activate signal is forwarded from the
+   * #GtkText::activated signal, which is a keybinding
+   * signal for all forms of the Enter key.
+   */
   signals[ACTIVATE] =
     g_signal_new (I_("activate"),
                   G_OBJECT_CLASS_TYPE (object_class),

diff --git a/gtk/gtktext.c b/gtk/gtktext.c
index 2d13cd245bee72eec427c343e3466c993aa43b17..da11cffe9b94cde407912590b31f343f1f6a3a69 100644 (file)
--- a/gtk/gtktext.c
+++ b/gtk/gtktext.c
@@ -949,7 +949,7 @@ gtk_text_class_init (GtkTextClass *class)
   
   /**
    * GtkText::activate:
-   * @self: The self on which the signal is emitted
+   * @self: The widget on which the signal is emitted
    *
    * The ::activate signal is emitted when the user hits
    * the Enter key.